Feature/try webtools inscentives by MSACC · Pull Request #382 · pluginpal/strapi-webtools

MSACC · 2026-03-01T14:35:40Z

What does it do?

Adds an incentive/trial system for pro addons in the Webtools admin UI:

Locked addon items appear in the sidebar navigation with a lock icon when a pro addon is not installed
Clicking a locked addon opens a TrialModal showcasing the addon's features and value proposition
The Overview page shows both installed addons and locked pro addons (Redirects, Links, Breadcrumbs)
Addon detection is based on plugin package name (not UI label) to support translations
New components: LockedAddonMenuItem, TrialCallToAction, TrialModal, ProAddonCard

Why is it needed?

To make users aware of available pro addons and provide a clear upgrade path when they encounter features that require a paid plan.

How to test it?

yarn develop + yarn playground:develop
Open Webtools in the admin → http://localhost:1337/admin
Sidebar shows locked addon items (Redirects, Links, Breadcrumbs) with a lock icon
Click a locked addon → TrialModal opens with features and CTA
"Start free trial" button links to the polar.sh checkout page

Related issue(s)/PR(s)

N/A

Introduce a LinksOverview admin screen and register it in the playground admin app. Update addon detection logic in App and Overview to use addon labels/names (case-insensitive) to determine installed vs locked Pro addons, add lockedProAddons and hasProLicense helpers, and only show the "Try Premium" CTA when no Pro addon is installed. Add playground changes for local testing: include webtools addon deps and activation metadata in package.json, add a WEBTOOLS license entry to .env, add a scoped .yarnrc.yml for the pluginpal registry, and update generated types to include breadcrumbs and redirects content types. (yarn.lock updated to reflect dependency additions.)

changeset-bot · 2026-03-01T14:35:44Z

🦋 Changeset detected

Latest commit: 692f41e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
strapi-plugin-webtools	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

…/pluginpal/strapi-webtools into feature/try-webtools-inscentives

Add generated TypeScript build info file (dist/tsconfig.tsbuildinfo) produced by the TypeScript build. Also apply updates to packages/core/admin/components/TrialModal/index.tsx — minor changes to the TrialModal component were made alongside the build output.

codecov · 2026-03-01T15:03:48Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 35.96%. Comparing base (af063d7) to head (692f41e).

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #382   +/-   ##
=======================================
  Coverage   35.96%   35.96%           
=======================================
  Files           2        2           
  Lines         723      723           
  Branches      172      172           
=======================================
  Hits          260      260           
  Misses        368      368           
  Partials       95       95

Flag	Coverage Δ
unit	`35.96% <ø> (ø)`

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

boazpoolman · 2026-03-02T13:46:52Z

packages/core/admin/containers/App/index.tsx


+  // Get list of installed addon labels (e.g., "Redirects", "Links", "Breadcrumbs")
+  const installedAddonLabels = routerComponents
+    .map((route) => route.label?.toLowerCase())


Better not to map this to the route label. That would cause this to break when those labels are translated. You could use this query to find all the enabled addons:

const addons = useQuery('addons', async () => get<WebtoolsAddonInfo[]>('/webtools/info/addons'));

Then we should match on the package name rather than the label.

Fixed in 5d7ff4b — now using useQuery('addons', ...) and matching on plugin package name instead of route label.

boazpoolman · 2026-03-02T13:49:22Z

packages/core/admin/screens/LinksOverview/index.tsx

I would rather have this file be in the links addon itself. Then when we want to actually implement that links overview page, we don't need to remove this page in the core plugin.

Fixed in 5d7ff4b — file removed from core. Will live in the links addon once that's implemented.

boazpoolman · 2026-03-02T13:50:27Z

packages/core/admin/screens/Overview/index.tsx

+  const installedAddons = Object.values(addons.data.data || {});
+
+  // Get list of installed addon names (e.g., "Redirects", "Links", "Breadcrumbs")
+  const installedAddonNames = installedAddons.map((addon) => addon.info.addonName.toLowerCase());


Again, don't map to the addonName, but to the package name to allow translatability.

Fixed in 5d7ff4b — now matching on info.name (plugin package name) instead of addonName.

boazpoolman · 2026-03-02T13:53:38Z

playground/src/admin/app.tsx

+export default {
+  register(app: any) {
+    // Register Links addon overview screen
+    const webtoolsPlugin = app.getPlugin('webtools');


This can be removed if we inject the route from the links plugin.

Fixed in 5d7ff4b — LinksOverview registration removed.

boazpoolman · 2026-03-02T13:54:04Z

playground/.env

 ADMIN_JWT_SECRET=tobemodified
 JWT_SECRET=tobemodified
+
+WEBTOOLS_LICENSE_KEY=WEBTOOLS-4F4D6E86-270C-461A-B1FB-F58B5A707793


Fixed in b980e9f + fa72039 — .env removed from git. .yarnrc.yml also contained the key and has been removed as well. Key has been rotated.

boazpoolman · 2026-03-02T13:54:20Z

playground/package.json

    "sitemap": "strapi-sitemap"
  },
  "dependencies": {
+    "@pluginpal/webtools-addon-breadcrumbs": "^1.0.3",


These should be removed from the core playground.

Fixed in 94a0a8d — addon dependencies removed from core playground.

Removed unused plugin dependencies from package.json

Replace label-based addon detection with package-name-based detection using the addons API (/webtools/info/addons). This prevents breakage when addon labels are translated. - App/index.tsx: query addons API, match on info.name vs packageName - Overview/index.tsx: use info.name (plugin name) vs proAddon.packageName - Remove LinksOverview screen from core (belongs in the links addon) - Clean up playground/app.tsx (remove LinksOverview injection) - Add WEBTOOLS_LICENSE_KEY placeholder to playground/.env.example Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

The .yarnrc.yml contained a hardcoded npmAuthToken (license key). Since all @pluginpal/* packages have been removed from the playground dependencies, the private registry config is no longer needed. Regenerated yarn.lock after dependency cleanup in previous commit. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Remove no-confusing-arrow violation in getPluginName (use block body) - Fix max-len violations by shortening inline comments - Remove no-unnecessary-type-assertion in App/index.tsx Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

The .env was accidentally deleted from git tracking in b980e9f. Tests require it to boot the Strapi instance (ADMIN_JWT_SECRET etc.). Restored with placeholder values only — no real secrets. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Introduce CLAUDE.md to guide Claude Code agents working with this repository. The file documents project structure (packages, playground), development setup and workflows (yarn, playground, watch builds), testing (unit/integration/e2e), linting and TypeScript checks, plugin architecture (server/admin entry points, URL patterns/aliases, middlewares, services), addon system and admin UI integration, configuration examples, common development patterns, release process, and troubleshooting tips.

MSACC added 2 commits March 1, 2026 15:04

Trial windows

35f4c66

MSACC requested a review from boazpoolman March 1, 2026 14:35

MSACC added 4 commits March 1, 2026 15:39

Add changeset for strapi-plugin-webtools patch

fbf8b1a

Fix eslint errors

f9965f5

Merge branch 'feature/try-webtools-inscentives' of https://github.com…

f5f0d87

…/pluginpal/strapi-webtools into feature/try-webtools-inscentives

Delete dist/tsconfig.tsbuildinfo

1810a4e

boazpoolman requested changes Mar 2, 2026

View reviewed changes

MSACC and others added 7 commits March 2, 2026 14:58

Delete playground/.env

b980e9f

Remove unused plugin dependencies

94a0a8d

Removed unused plugin dependencies from package.json

fix: update polar.sh checkout URL

b8e1798

MSACC requested a review from boazpoolman March 14, 2026 12:08

MSACC added 3 commits March 14, 2026 13:16

chore: regenerate playground types after breadcrumbs addon removal

7f082d1

Merge branch 'master' into feature/try-webtools-inscentives

692f41e

Uh oh!

Conversation

MSACC commented Mar 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does it do?

Why is it needed?

How to test it?

Related issue(s)/PR(s)

Uh oh!

changeset-bot bot commented Mar 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

codecov bot commented Mar 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

MSACC commented Mar 1, 2026 •

edited

Loading

changeset-bot bot commented Mar 1, 2026 •

edited

Loading

codecov bot commented Mar 1, 2026 •

edited

Loading